home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 4 / Gold Medal Software - Volume 4 (Gold Medal) (1994).iso / os2 / fbar14.arj / FILEBAR.TXT < prev    next >
Text File  |  1994-02-10  |  22KB  |  444 lines
  1. ===============================================================================
  2. -------------------------------------------------------------------------------
  3.            
  4.                 FileBar - Version 1.4
  5.         
  6.         An OS/2 Application Launch Facility and WPS Replacement
  7.        Written By Eric A. Wolf - Copyright (C) 1994 - All Rights Reserved
  8.  
  9. This program is SHAREWARE!  Please read the registration information at the end
  10.      of this document for details on how to register your copy of FileBar.
  11.  
  12. -------------------------------------------------------------------------------
  13. ===============================================================================
  14.  
  15.  
  16.  
  17. == Introduction ============
  18.  
  19. FileBar, quite simply, is a menubar for your desktop.  It is intended to ease 
  20. the operation of launching frequently used applications and from jumping from 
  21. task to task within OS/2.  Spanning across the top or bottom of your desktop, 
  22. FileBar is intended to give you quick and easy access to your most used 
  23. applications (whether they are DOS, Windows or OS/2 applications).  You have 
  24. seven menus in which you can place a maximum of 24 different items in each.  
  25. Each item may represent a command shell to boot, a script file to perform a
  26. task or even your favorite application.  With FileBar, you're just one click 
  27. away from your favorite and most used programs.  Also, FileBar can be used
  28. as a regular application or you can use it to replace your existing Workplace 
  29. Shell in order to provide you with much more memory for the rest of your 
  30. programs (thus, speeding up your system).
  31.  
  32. -------------------------------------------------------------------------------
  33.  
  34. == Installation ============
  35.  
  36. If you are installing FileBar for the first time, please continue to the next
  37. paragraph.  If you are simply upgrading filebar, keep a copy of your old
  38. filebar.ini initialization file.  Delete ALL the files associated with the
  39. older version of FileBar, unzip this newer version and copy your previous
  40. filebar.ini file back into the directory.  (Now, skip to the Using FileBar
  41. section)
  42.  
  43. Installing FileBar is simple.  Read the readme file and once you agree to
  44. register the product if you continue to use it, unzip the second zipfile,
  45. FILEBAR.ZIP.  Now, simply go to an OS/2 prompt, and type INSTALL from the
  46. same directory where you unzipped the files.  That will invoke a REXX script
  47. that will create a FileBar program object/icon on the desktop for you to
  48. use to start FileBar.
  49.  
  50. To immediately start FileBar, double click the program object on the desktop.
  51. And to make FileBar start every time you boot OS/2, drag the object to the
  52. startup folder that is found in the OS/2 system folder.
  53.  
  54. (NOTE:  You should proceed to unzip the second zipfile ONLY if you agree to
  55.     the registration requirements presented both in the README file and
  56.     in the registration text at the end of this document.)
  57.  
  58. Installing FileBar as a WPS replacement:
  59. ----------------------------------------
  60. FileBar has the capability to be used as a replacement shell.  This means,
  61. instead of using the WPS, you can use FileBar.  Doing this greatly reduces
  62. the amount of memory the system uses and can give your programs an extra
  63. two or three megabytes of memory to run in (resulting in speed increases).
  64.  
  65. If you wish to use FileBar over the WPS as your shell, simply edit your
  66. OS/2 config.sys and change the line that reads:
  67.  
  68. SET RUNWORKPLACE=PM_Shell_Path\PMSHELL.EXE
  69.  
  70. to
  71.  
  72. SET RUNWORKPLACE=Put_Complete_FileBar_Path_Here\FILEBAR.EXE
  73.  
  74. The next time you boot OS/2, you will have FileBar as your shell.  To change
  75. back to WPS, simply change the line back to PMSHELL.
  76.  
  77. -------------------------------------------------------------------------------
  78.  
  79. == Using FileBar =============
  80.  
  81. Once FileBar is started, you will see the FileBar across the top of your screen.
  82. You access functions in FileBar like any other menu bar that is in any other
  83. OS/2 application.  The menubar may be positioned at the top or the bottom of
  84. your desktop (see below for instructions on moving it).  The current time
  85. and or date may also be displayed on the FileBar for convenience (again, see
  86. below for details).
  87.  
  88. The first time you boot FileBar, it comes preconfigured with several menus.
  89. The first two, FileBar and Task List are static (that is, unchangable by the
  90. user) but the remaining menus may be added to, changed or even deleted and
  91. replace by more of your own menus.
  92.  
  93. The functions of the menus are explained below:
  94.  
  95.     FileBar
  96.     -------
  97.       Move to Bottom/Top:  This option changes the position of the FileBar on
  98.                the desktop.  Select this option to toggle the
  99.                position of the FileBar on the desktop.
  100.       
  101.       Edit FileBar:  This is where you add, remove or change the appearence of
  102.       Menus:         your user menus.  When you select this option, you will
  103.              be presented with all of your currently defined menus.
  104.              You may remove entire menus by selecting Remove Menu or
  105.              you may change the order of your menus by selecting a
  106.              menu and then clicking Move Menu < or Move Menu > to
  107.              move your menu left or right on the filebar menu.
  108.              You may also add a menu by simply clicking Add Menu and
  109.              typing a title for your new menu.  You may edit the 
  110.              items of a menu by selecting Change Menu (or by double
  111.              clicking a menu item) or you may go back to
  112.              normal FileBar operation by clicking OK.
  113.  
  114.              If you choose to change your menu, you will be
  115.              presented with all the items currently under the
  116.              selected menu.  You may change the name of an
  117.              existing menu by overwriting the name of the menu in
  118.              the menu name entry field.  You may move items up and
  119.              down, insert menu separators, delete items or insert
  120.              (add) items.  Selecting OK will return you to the 
  121.              menu selection dialog box.
  122.  
  123.              If you choose to add an item (or change an existing
  124.              item), you will be presented with a dialog containing
  125.              the item's name (which may be changed by simply typing
  126.              in the new name into the name entry field), the type
  127.              of program you wish to run (OS/2, DOS or Windows
  128.              application), whether the program should start
  129.              maximized or minimized, the complete pathname of the
  130.              program to execute if this item is selected off the
  131.              menu, any command-line arguments that should be passed
  132.              to the program and the starting directory for the
  133.              program.
  134.  
  135.              (You may also edit a menu item by double clicking it).
  136.  
  137.              Clicking OK saves the information and returns you to
  138.              item editing dialog box.  If you click Find File, you
  139.              will be presented with a dialog box to allow you to
  140.              browse over your disk drives and find a file you wish
  141.              to execute.  Select Cancel to abort this operation and
  142.              return to the previous dialog.  If you select a file
  143.              from here, the pathname of the file, the directory and
  144.              the program type will be set for this program when you
  145.              return to the item editing dialog box.
  146.  
  147.              In the edit item data dialog window, you may click
  148.              Reset to restore the data for the item you had before
  149.              you opened the dialog or you may press cancel if you
  150.              wish to abandon your changes.
  151.  
  152.           OPENING WPS FOLDERS 
  153.              In the 'edit item' dialog, there is also a feature to
  154.              open Workplace Shell folders.  To enable this feature,
  155.              simply drag a copy of the folder you want to open to
  156.              the area marked on the dialog and drop it.  The 
  157.              dialog will then configure itself to open that folder
  158.              whenever the item is selected.  (Note that you may
  159.              ONLY drag folders to the dialog!)  Once you drop the
  160.              folder, simply click OK because the settings are correct.
  161.  
  162.           USING SETTINGS
  163.              If you have a program that requires specialized
  164.              settings, you may mark the program to be launched as
  165.              a WPS program and you will then be given the oppurtunity
  166.              to modify any settings you may need to for the program.
  167.              Remember, in order to use and modify program settings,
  168.              you must have the program marked as launchable as a
  169.              WPS object.  In order to correctly use this option,
  170.              you MUST FULLY QUALIFY THE PATHNAME!  (instead of
  171.              entering just FILEBAR.EXE you must enter 
  172.              C:\OS2\FILEBAR\FILEBAR.EXE).  This way OS/2 can
  173.              associate the settings you specify with the executable.
  174.  
  175.              Note that each executable only has 1 set of options,  If
  176.              you want to set up a program with two different sets of
  177.              options, make a copy of the executable and set the 2nd
  178.              set of options for the new copy of the executable and
  179.              set FileBar to launch that file.
  180.       
  181.       Time/Date Options:  This option lets you select what is displayed on
  182.               the far right of the FileBar at all times.  You 
  183.               have the choices of displaying nothing, the 
  184.               current time, the current date, or both the 
  185.               the current time and date and also all of these
  186.               options in international format.
  187.       
  188.       Save menu configuration:  Although menu and configuration information
  189.                 is saved everytime you exit FileBar, you
  190.                 can force FileBar to save your configuration
  191.                 if you select this option.
  192.  
  193.       Confirm on Task Close:  This menu item should be checked if you want
  194.                   FileBar to double check with you before
  195.                   terminating an application.
  196.       
  197.       Background Bitmap:  Use this option only if you are using FileBar as a
  198.               WPS replacement.  This functions similarly to the
  199.               WPS background bitmap setting.  Select whether you
  200.               want to display the bitmap or not and also how
  201.               (scaled to fit screen, normal, or tiled image).
  202.               The complete pathname of the image should be
  203.               entered into the entry field.  You may use the
  204.               Find button to help you locate images.  (Note that
  205.               ONLY .BMP images can be used for this option).
  206.       
  207.       Use Alternate FileBar Menu:  Selecting this toggles whether the FileBar
  208.                    System menu will be the name FileBar or
  209.                    just a sigle character symbol.  Use the
  210.                    single symbol if you want the menu to use
  211.                    less menubar real-estate.
  212.       
  213.       Product Information:  This option shows author, copyright and 
  214.                 program information.
  215.       
  216.       Exit:  This option allows you to exit the FileBar application and save
  217.          its current state in the option file, FILEBAR.INI.  The state
  218.          is only saved when the application is terminated!
  219.  
  220.     TaskList
  221.     --------
  222.       Each item in this menu represents a currently active OS/2 task.  This
  223.       menu is updated each time it is accessed and allows you a single-click
  224.       option to jump between OS/2 processes.  Any running OS/2 task will be
  225.       displayed in this menu.  There is also a cascaded menu that may be
  226.       selected for each item.  If you select this additional menu, you will
  227.       be allowed to switch to the task, close the task, show or hide the
  228.       task as well as minimize or maximize the task.  Note, that if you
  229.       do not select the cascaded menu, but simply select just a task name,
  230.       you will jump to that task.
  231.  
  232.       There is also shutdown option that when selected will shutdown your system.
  233.  
  234.     User Menus
  235.     ----------
  236.       Selecting an item in any of the seven user menus results in the file
  237.       specified in the item's options information to be started using the
  238.       information specified in the item information (see Edit FileBar Menus
  239.       for more information on modifying this information).  This is how the
  240.       user will go about launching applications they want to get to frequently.
  241.  
  242. Notes:  
  243. ======
  244.  
  245. * You may notice that the FileBar will flash for a brief moment.  This is
  246.   because the time has changed and OS/2 is changing the time on the menu
  247.   bar.  This flash is just the way OS/2 updates the menu.
  248.  
  249. * When entering command line parameters, you can specify that some or all of
  250.   the options be entered when the program is started.  If you enclose one
  251.   or parameters in brackets ( [ and ] ) then FileBar will prompt you to enter
  252.   the parameter(s) when the item is launched.
  253.  
  254. * You may drag a font to the FileBar (from the Font Palette) if you wish
  255.   to change the font FileBar uses for its menus.  After you drop a font,
  256.   the menu bar will change to accomdate this new font.  The font you drop
  257.   will be remembered next time you start FileBar.  If you find yourself
  258.   running out of room on your menubar because you are using long menu names,
  259.   simply drag and drop a smaller font to FileBar (from the font palette in
  260.   the OS/2 system folder).
  261.  
  262. * You may use the tilde (~) in your menu and item names to signify that the
  263.   character immediately following the tilde should be used as an
  264.   accelerator for accessing the respective menus or items.
  265.  
  266. * All changes made (time/date, bar position, menu contents, etc.) are saved
  267.   each time FileBar is closed (or the system is shutdown or an explicit save
  268.   operation is requested).  FileBar is restored to the state it was saved in
  269.   next time it is executed.  Changes are saved ONLY during these times.
  270.  
  271. * The configuration information for the FileBar is stored in a file named
  272.   FILEBAR.INI (in the directory where FILEBAR.EXE is located) and may be
  273.   backed up by the user for added protection.  It is a strictly text file
  274.   and may be backed up by copying a valid FILEBAR.INI file to another, 
  275.   unused filename (ie: COPY FILEBAR.INI BACKUP.INI)
  276.  
  277. * FileBar comes with two sample FileBar configurations, SAMPLE1.INI and
  278.   SAMPLE2.INI.  To try these out, copy one of them over your FileBar .INI
  279.   file (ie: COPY SAMPLE1.INI FILEBAR.INI).  NOTE!  This will overwrite your
  280.   current FileBar configuration and destroy the contents it currently has.
  281.   These contain samples for how to launch DOS windowed and full screen 
  282.   sessions, OS/2 windowed and full screen sessions, and Win-OS/2 windowed
  283.   and full screen sessions, among other things.  Refer to these for tips on
  284.   how to set up your own FileBar!
  285.  
  286. * If you wish to add items that launch OS/2 command shells (DOS windows,
  287.   DOS full-screens, WIN-OS2 sessions, etc.), see the SAMPLE1 or SAMPLE2
  288.   .INI files.  For OS/2 and DOS sessions, simply select what type of command
  289.   shell you would like (from application type section) and then leave the
  290.   Program Path empty.  That will start a command shell (DOS window, DOS
  291.   fullscreen, OS/2 window, and OS/2 fullscreen sessions).
  292.  
  293.   However, if you want to start a WINOS/2 windowed session, put PROGMAN.EXE
  294.   in the program path (it will start program manager for you).  If you want
  295.   to launch a fullscreen WINOS/2 session, put WIN.COM in the program path
  296.   section of the text.
  297.  
  298.   Again, see the examples provided for the exact details on how to launch
  299.   command shells from FileBar.
  300.  
  301. * If you wish to make an item on one of your menus that is an OS2, DOS or 
  302.   WINOS2 session that has modified settings, follow the instructions
  303.   below:
  304.  
  305.   - For OS/2 sessions, go to the \OS2 directory and make a copy of CMD.EXE.
  306.     Make FileBar point to this new copy of the executable and mark it to
  307.     boot as a WPS program object.  Now, change the settings as you wish.
  308.  
  309.   - For DOS sessions, go to the \OS2\MDOS directory and make a copy of 
  310.     COMMAND.COM.  Make FileBar point to this new copy of the executable and
  311.     mark it to boot as a WPS program object.  Now, change the settings as
  312.     you wish.
  313.  
  314.   - For WINOS2 sessions, go to the \OS2\MDOS\WINOS2 directory and make a
  315.     copy of WIN.COM for fullscreen sessions or PROGMAN.EXE for windowed
  316.     sessions.  Make FileBar point to this new copy of the executable
  317.     and mark it to boot as a WPS program object.  Now, change the settings
  318.     as you wish.
  319.  
  320. * Since WPS settings are implemented to be tied to the executable of the
  321.   program that is being launched, if you need two or more programs with the
  322.   same settings, you will need to make a copy of that executable with a 
  323.   different name and give it different settings.  Command prompts work in
  324.   the same way.  (Simply make a copy of CMD.EXE or COMMAND.COM and name it
  325.   something differently.  Give it new settings and when you launched this
  326.   renamed object, it will come up with the new settings (if using use WPS
  327.   settings option)).
  328.  
  329. -------------------------------------------------------------------------------
  330.  
  331. == Registration ============
  332.  
  333. If you like FileBar, or perhaps, you enjoy having the complete source code
  334. for an OS/2 PM program to aid you in writing your own programs, I ask you to
  335. register your copy of the program.  The registration cost is only $10.00 and
  336. it will ONLY be with your support that I continue to develop for OS/2, 
  337. and especially, provide the complete source code for any of my works.
  338.  
  339. You can register your copy of FileBar with me for only $10.00.  Please send 
  340. your registration payment as a check or money order (US funds only) to:
  341.  
  342.             Eric A. Wolf
  343.             498 Wiley Hall NW
  344.             West Lafayette, Indiana  47906-4223
  345.  
  346.  
  347. After 4/30/94, please send your registration payment to:
  348.  
  349.             Eric A. Wolf
  350.             1630 North Johnson Street
  351.             South Bend, Indiana  46628-2936
  352.  
  353. I want to encourage everyone to start writing applications for OS/2, no
  354. matter how simple or complex.  That is why I am providing the source code 
  355. with this program.  If you've never developed for OS/2 before, now is your
  356. time to start and you have this to look off of to get you going.
  357.  
  358. Please note, however, I provide the source code as-is and as a learning tool 
  359. for aspiring programmers.  Please do NOT modify the source code and re-release 
  360. an exact or similar product.  The source is provided solely as a learning 
  361. device.  The $10.00 registration fee is cheaper than any OS/2 programming 
  362. book and what I provide is a complete, functional OS/2 PM application and 
  363. ALL component source files that comprise it (how many books do that?)
  364.  
  365. If the response is good enough, and only if it is good enough, I will continue 
  366. to develop products and ship the source code along with them.
  367.  
  368. I will answer no questions about the source code of the program from an
  369. individual until a registration payment has been received.  Once registered,
  370. source questions can be directed to me via electronic mail only:
  371.         
  372.         CompuServe:   71575,1515
  373.         Delphi:       OLDGROUCH
  374.         internet:     ericwolf@mentor.cc.purdue.edu
  375.  
  376. If you have general comments or questions about the program, you may also
  377. send them to any of the electronic addresses above.  Thanks!
  378.  
  379. -------------------------------------------------------------------------------
  380.  
  381. == Source Code ===========
  382.  
  383. This program comes complete with the entire source code that generated it.
  384. Please note the following restriction:
  385.  
  386.    FileBar's source code is to be modified by the author alone.  The source
  387.    code is provided as a learning tool ONLY!  No modifications may be made
  388.    to it to reproduce a same or similar product.  The copyright remains that
  389.    solely of the author and the program is protected under both United States 
  390.    and International Copyright Laws.
  391.  
  392. The complete source code for this program can be found in the SOURCE
  393. directory that was created when you uncompressed this program.  It was
  394. developed on Borland's C++ for OS/2.  A project file (FILEBAR.PRJ) has been
  395. provided to facilitate your working with these files.  Each source file
  396. is documented and you should review the code with some good OS/2 references
  397. in hand (PM references, API reference, etc.)  
  398.  
  399. -------------------------------------------------------------------------------
  400.  
  401. == Distribution of FileBar ========================
  402.  
  403. You are free to distribute FileBar to whomever and however you wish as long
  404. as the following conditions are upheld:
  405.  
  406.   -  FileBar should always be distributed in its entirety.  This includes
  407.      all documentation, executables, and source files.  Under no circumstances
  408.      should FileBar be distributed without all of its original files.
  409.      Distribution of FileBar (in any way possible!) is strongly encouraged by
  410.      individuals and software houses!
  411.  
  412.   -  FileBar's source code is to be modified by the author alone.  The source
  413.      code is provided as a learning tool ONLY!  No modifications may be made
  414.      to it to reproduce a same or similar product.  The copyright remains that
  415.      of solely the author and the program is protected under both United States 
  416.      and International Copyright Laws.
  417.  
  418.   -  If you use FileBar, you MUST register it (directions for doing so
  419.      preceeded this section of the text).  "Use" includes both the actual
  420.      use of the FileBar application program -or- using the source code 
  421.      as a reference for your own works.  If you use the source as a reference, 
  422.      please register your copy ($10.00 is cheaper than any book you can buy on
  423.      OS/2 programming and what is going to teach you as much??)  
  424.      
  425.   -  Remember, if you like the program (even if you don't care much for the 
  426.      source code) you should still register!!
  427.  
  428. -------------------------------------------------------------------------------
  429.  
  430. == Revision History ========================
  431.  
  432. (The revision history is contained the HISTORY.TXT file that should have
  433.  come with this file...  Contact the system administrator from which you
  434.  received these files if it did not!)
  435.  
  436. -------------------------------------------------------------------------------
  437.  
  438.  
  439.    -------------------------------------------------------------------------
  440.    Remember if you like FileBar and use  it or if you use or plan to use the
  441.      source code as a reference for your own works, please register today!
  442.    -------------------------------------------------------------------------
  443.  
  444.